Acacia
What's new in Acacia
Acacia is the first release in our new API versioning model—you can read more about the model in our announcement post. As the first version in the Acacia release, 2024-09-30.
introduces both breaking changes and new features—the next Acacia versions include only additive changes.
October 28th, 2024
- Billing now supports Credit Grants: You can now create credits for customers that you can then apply to invoices as discounts and credit notes.
- Expanded payment method support: You can now accept a number of South Korean payment methods (cards, Naver Pay, Kakao Pay, Samsung Pay, and PAYCO) in many Stripe products and use Alma, a buy now, pay later payment method in France.
- Event Destinations API: We now provide an API for managing event destinations, which allow you to receive events at both webhook endpoints and cloud services, like Amazon EventBridge.
- Tax improvements: We now support tax registrations and tax IDs for more countries. You can also automatically validate a customer’s tax location when updating them.
September 30th, 2024
- Improved usage-based billing capabilities: The Meter Events v2 API supports high-throughput usage reporting (up to 10,000 events per stream), including alerting and monitoring. Learn more about APIs in the v2 namespace.
- Terminal updates: The S700 reader is generally available. You can now track offline card present transactions collected through Terminal’s mobile SDKs.
- Expanded payment method support: You can offer Multibanco, Twint, and Zip as payment options on Payment Links and Invoices.
- Billing and invoicing improvements: We support tax IDs for Switzerland and Croatia. You can perform bulk operations for invoices in a single API call and define alerts based on billing thresholds.
- Improved customer-facing flows: We improved validations for shipping addresses and the Issuing card creation flow. You can now integrate Payment Elements within Customer Sessions.
- More filtering options for Financial Connections: You can filter accounts by subcategories (for example, checking, savings, and mortgages).
- New thin event payload type: You can more easily maintain future webhook integrations with thin events, which are unversioned and only contain the IDs of the objects related to the event. Learn more about thin events.
To get started with these updates, review the changelog and upgrade your API version.
2024-10-28.acacia
Billing credit grants
Adds Credit Grant APIs and resources | Billing+ 1 more | |
Adds support for pre-tax credit amount information to invoices | Billing+ 1 more | |
Adds support for pre-tax credit amount information to credit notes | Billing+ 1 more |
New payment methods
Adds support for new South Korean payment methods | Billing+ 5 more | |
Adds support for Alma in France | Checkout+ 3 more |
Event destinations and event types
Adds Event Destinations v2 API endpoint | ||
Adds event type for updated receipt data in Issuing transactions | Issuing |
Payment method enhancements
Adds a metadata field to the Vault and Forward API | Payments | |
Adds Polish PLN currency support to Terminal tipping configuration | Terminal | |
Supports domain registration for Amazon Pay | Elements |
Additional tax registration options
Adds support for new countries to the Tax Registration API | Tax | |
Adds support for tax ID types in several new countries | Tax | |
Adds support for collecting retail delivery fees | Tax | |
Adds option to automatically validate customer tax location during an update | Tax |
Additional updates
Adds support for disabling Stripe user authentication for certain embedded components | Connect | |
Adds a test helper that updates the shipping status for physical cards | Issuing | |
Adds created, updated, and failed events for all refund types | Payments | |
Adds pricing groups to the Accounts API | Connect+ 1 more | |
Adds scheduled subscription downgrades in the customer portal | Billing | |
Makes business profile optional for customer portal configuration | Billing | |
Uses Visa’s Compelling Evidence 3.0 to respond to qualifying disputes | ||
Adds support for scheduling invoice finalization | Invoicing |
2024-09-30.acacia
Breaking changes
Add alerts, monitoring, and reporting to usage-based billing
Adds contextual filters to billing alerts | Billing | |
Adds an Alerts API for usage-based billing | Billing | |
Adds an event for triggered billing alerts | Billing | |
Adds support for listening to triggered billing alerts | Billing | |
Adds billing alert resources and endpoints | Billing | |
Adds support for subscriptions and subscription items to billing alerts | Billing+ 1 more | |
Adds Meter Event v2 API endpoints | Billing |
Enhancements for Terminal readers and integrations
Updates consent modeling for saving cards with Terminal | Terminal | |
Adds support for configuring the reboot time setting | Terminal | |
Adds the Stripe S700 reader as a valid device type | Terminal | |
Adds details about offline collection on card_ PaymentMethod objects | Terminal |
Payment method enhancements
Adds option to retrieve CVC tokens on Confirmation Tokens | Elements | |
Adds customer ID to payment method preview on a confirmation token | Elements | |
Adds support for identifying the unique payer for the BLIK payment method | Payments | |
Adds support for Affirm transaction IDs | Payments | |
Adds support for in-person payment methods, including Interac cards | Terminal | |
Displays authorization_ for Charges | Payments | |
Adds wallet details for card_ Charges and Payment Methods | Terminal | |
Adds country field for Charges that use Klarna | Payments | |
Displays Amazon Pay dispute type on Disputes | Payments |
Add support for new payment methods
Adds support for three new payment methods: Multibanco, Twint, and Zip | Payment Links | |
Adds support for using the Multibanco payment method with billing | Billing | |
Adds Twint to the PaymentMethodConfiguration API | Payments | |
Adds Girocard as a PaymentMethod brand and network | Payments |
Add tax IDs for Switzerland and Croatia, and optional tax ID requirement
Adds Switzerland UID as a supported customer tax ID | Invoicing+ 1 more | |
Adds Croatian Personal Identification Number to supported Tax IDs | Billing+ 2 more | |
Adds support for requiring a customer tax ID on Checkout and Payment Links | Checkout+ 1 more |
Add filtering support for Financial Connections
Adds support for filtering by account subcategories on Financial Connections | Financial Connections | |
Expands filtering support for Financial Connections Sessions | Financial Connections |
New error codes for more robust testing
Adds error code for exceeded transaction limits | Invoicing+ 1 more | |
Adds new error code for invalid mandate prefixes to Bacs Direct Debit and SEPA Direct Debit payments | Payments |
Add new Invoice Rendering Template resource
Adds Invoice Rendering Templates for Invoices | Invoicing | |
Adds retrieve and archive methods for Invoice Rendering Templates | Invoicing | |
Adds support for templates to Invoices and Customers | Invoicing | |
Adds version support for Invoice Rendering Templates | Invoicing |
Improve address validation and dispute and regulatory management for Issuing
Updates the default value for shipping address validation | Issuing | |
Adds address validation for physical cards | Issuing | |
Adds a new webhook event for when funds are deducted as part of a dispute | Issuing |
Streamline invoice processing
Adds support for bulk invoice line item operations | Invoicing | |
Adds webhook events for when an invoice is due or overdue | Billing | |
Adds option to automatically finalize invoices | Invoicing |
Tax enhancements
Adds support for posting time on tax transaction creation | Tax | |
Adds support for tax settings and registrations for Embedded Components | Connect+ 1 more | |
Adds new method to retrieve a Tax Calculation | Tax | |
Adds support for specifying US state sales tax elections while creating tax registrations | Tax |
Additional updates
Adds risk verification details for connected accounts | Connect | |
Adds support for email types to Credit Notes | Invoicing | |
Adds support for the Payment Element on a Customer Session | Elements | |
Adds support for identifying the case type for card disputes | Payments | |
Adds a method to update the metadata for Checkout Sessions | Checkout | |
Adds parameter to link Verification Sessions to Customers | Identity | |
Displays CHIPS tracking details for outbound wire payments and transfers | Treasury | |
Adds additional reasonable defaulting to the Account Link API v1 | Connect | |
Makes LineItem. optional | Checkout | |
Adds target_ for advancing test_ objects | Billing | |
Makes status details for Test Clock test helpers required | Billing | |
Adds a new enum value representing a ReceivedDebit failure due to an international transaction | Treasury | |
Makes it optional to update the products and prices of a subscription | Billing | |
Add support for custom_ during product creation | Checkout+ 1 more | |
Adds support for retrieving thin events | Billing |